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PREFACE 



This manual is for users and integrators of systems based on AMPRO ZBO-based 
Single board computers, utilizing the CF7M operating system. It describe* the 
optional hard disk software contained on the AMPRO Z80 Hard Disk Software 
diskette, He-e is an overview of what is included in this manual: 

Chapter 1 - GENERAL INFORMATION - Features of the ZBO hard disk software. 
Conventions used in program operation descriptions. 

Chapter 2 - SOFTWARE INSTALLATION - Hardware setup and software configuration 
procedures. 

Chapter 3 - PROGRAM DESCRIPTIONS - Detailed descriptions and operating 
instructions for each of the hard disk software utilities. 

Chapter 3 is intended to provide a convenient user reference. The program 
descriptions are arranged alphabetically, and each program's name appears on 
the bottom of the page, to aid you in locating the program description. 

Each AMPRO program has a version number, and revision level. For example 
"Version 2.3" represents program Version 2, Revision 3. The version number is 
changed when a new program description is recuired. In most cases, the 
programs display their version number when you run them. This way you can tell 
if you have the right program description for the version of a program you. are 
using. As new (improved or enhanced) versions of programs become available, 
replacement program description sheets for your manual will also be provided. 



PLEASE NOTE 

Specifications and descriptions are subject to change without notice. Updates 
are available from AMPRO at nominal charge. The contents of this document are 
believed to be accurate. If errors are found, please notify AMPRO at the 
address shown on the title page of this document. 

Trademarks and registered trademarks used within this document - ZBO: Zilog, 
Inc.; CP/Mz Digital Research, Inc.; IBM: International Business Machines; 
ZCPP3: Richard L. Conn; LITTLE BOARD, LITTLE BOARD /PLUS, SCSI /PLUS: AMPRO. 

No part of this document may be reproduced in any form, for commercial 
purposes, without the express written consent of AMPRO Computers, Inc. 



Copyright (C) 1985, AMPRO COMPUTERS INCORPORATED 



TABLE OF CONTENTS 



CHAPTER 1 - GENERAL INFORMATION 

1.1 Introduction ........ 1-1 

1.2 Software Description .................. 1-1 

1.3 Conventions ............. 1-2 

1.4 References ....................... 1-2 

CHAPTER 2 - SOFTWARE INSTALLATION 

2.1 Introduction . 2-1 

2.2 Hardware Preparation ....... ... 2-1 

2.3 Software Installation 2-2 

CHAPTER 3 - PROGRAM DESCRIPTIONS 

3.1 Introduction 3-1 

3.2 Program Descriptions ............. 3-1 



FINDBAD .... Bad sector lockout 

HINIT ..... BIOS and controller initialization 

H r QRMAT .... Hard disk formatter 

HPARK ..... Moves 'hard disk head to landing zone 



CHAPTER I 
GENERAL INFORMATION 



1.1 INTRODUCTION 

This chapter primarily describes the optional hard disk software available "for 
the AMPRO ZBO-based single board computers and computer systems. Conventions 
to be used in program operating instructions are de-fined, and references -for 
further information are listed. 



1.2 HARD DISK SOFTWARE DESCRIPTION 

The AMPRO ZBO hard disk software provides support for a wide variety of hard 
disk system configurations. Use of the hard disk software requires either a 
system containing an AMPRO Little Board with an SCSI /PLUS ZBO Adapter, or an 
AMPRO Little Board/PLUS (with built-in SCSI /PLUS interface). AMPRO BIOS 
Version 3 is also required; the Version 3 BIOS contains generic SCSI (SASI) 
support, and has been designed to maximize the flexibility of your system's 
hard disk interface. 

The required Version 3 BIOS is available on the ZBO System Software diskette 
(AMPRO P/N A60101); the hard disk software utilities necessary tc format and 
install hard disk drives and controllers are contained on the ZBO Hard Disk 
Software diskette (P/N A600E7). If you do not already have the Version 3 BIOS, 
a software update is available from AMPRO for a nominal charge. Source cede 
for the BIOS and utilities is also available from AMPRO. 

He*-e are some of the features of the AMPRO hard disk software: 

o BIOS supports "generic" SCSI (SASI) controllers, and Xebec 1410/1410A 

o Up to eight hard disk controllers, with up to 11 hard disk drives of 
any size, up to B8 megabytes total storage 

o Variable CP/M partition sizes: 0.1 to 8 megabytes 

o CP/M drive letter swapping 

Although the Version 3 BIOS provides "generic" SCSI controller support, 
the SCSI format command has a number of "vendor unique" options which are not 
uniformly implemented. Consequently, only a limited number of SCSI controllers 
a^e directly supported by the AMPRO hard disk format utility (hFORMAT) . 
Controllers currently supported are: 

Adaptec ACB4000 

Shuga-t 1610-4 

Xebec 1410, 1410A, and OWL 

If you wish to use an unsupported controller, you you car, do this ty mca ikying 
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HFDRMAT to be compatible with the desired controller's format command. This 
usually involves a small change to the source code, which is available for a 
nominal charge -from AMPRO, in the ZBO Software Source Code package. 

Most SCSI (SASI) controllers currently being manufactured initialise themselves 
on powerup from parameters they write to the drive during the format process. 
Examples are the Adaptec and Shugart controllers, and the Xebe: OWL drive. 
Some controllers — like the Xebec 1410/1410A — are not auto-initializing, and 
must be initialized each time they are powered on. Like the format command, 
the initialization command is not standardized. The AMPRO HINIT utility 
provides optional controller initialization for only the Xebec controllers. If 
you wish to use an unsupported controller that does require initialization, you 
will have to modify HINIT to meet your controller's requirements; source code 
to HINIT is available in the Little Board Source Code package. 



1.3 CONVENTIONS 

In the descriptions of the use of software utilities, terminal keyboard inputs 
which you will make to the system are shown underlined. This has been done to 
make it easy for you to distinguish between the computer's prompts and the 
operator's keystrokes. For example: 

AO> HFQRMAT < RETURN > 

Also, certain keys on your terminal's keyboard have special uses. The control 
key, generally labeled CTRL, is meant to be pressed at the same time as one 
other key. The required control key combination will be represented as 
follows: <CTRL-C> 55 control key pressed along with C key. 

Two other special keys are the "escape" key, indicated by <ESC> and the 
"return" key (also called the "carriage return" or "enter" key), indicated by 
<RETURN>. In general, all commands you enter from the CF7M (or ZCPR3) command 
prompt require you to press the < RETURN > key to begin the operation, as in the 
e:* ample above. 



1.4 REFERENCES 

Only brief references are made in this manual to the use and operation of some 
required software utilities. Whenever a software utility is mentioned, it will 
either be called an AMPRO utility, a CP/M utility, or a ZCPR3 utility. This 
way you will know where to obtain further information on the program's use. 

Refer to the AMPRO 280 Software User's Manual (P/N A74006) for further 
information on other AMPRO-supplied software programs and utilities. 



1-2 



CHAPTER 2 
SOFTWARE INSTALLATION 



2.1 INTRODUCTION 

This chapter provides information on how to configure and install the AMPRD ZBO 
hard disk software. The required hard disk utilities are contained on the ZBO 
Hard Disk Software diskette (AMPRO P/N A60057). The AMPRD Version 3 BIOS, 
present on the ZBO System Software diskette (P/N A60101), is also necessary. 

This chapter will guide you through the required hardware and software 
setup and installation procedures. Refer to Chapter 3 for detailed program 
descriptions and operating instructions on the hard disk software utilities, 
and to the AMPRO Z80 System Software User's Manual (P/N A74006) for 
instructions on the use of other AMPRO software. 

NOTE 

Any modifications to the system parameters should only be 
performed using your backup disks. Do not modify the disks 
shipped with your system. 



2.2 HARDWARE PREPARATION 

The AMPRD ZBO hard disk software assumes the presence of either a Little Beard, 
with the 'ZBO SCSI Adapter option, or a Little Board/PLUS, with built-in SCSI 
interface. Be sure that conductor number 1 of the 50-conductor SCSI bus cable 
is plugged into pin 1 of the SCSI 50-pin connector. Often, the flat ribbon 
cable will have a red strip on one edge, indicating the location of conductor 
number 1. Also be sure that two — and only two — SCSI bus devices have their 
resistor terminator networks installed. 

You may connect up to eleven drives, on up to eight controllers, to your 
system. The drives may be any size, up to the system maximum of BS megabytes. 
Various drive and controller types may be intermixed. 

You will need the following information on each drive to be used: 

o Number of cylinders 

o Number of heads 

o Step rate 

o Cylinder number to begin write precompensation (if needed) 

o Cylinder number to begin reduced write current (if needed) 

In addition, each type of hard disk drive usually has a jumper configuration 
area, generally located near the 34-pin drive cable connector. Ccnswilt your 
drive's documentation to determine how it needs to be jumpered. If only cr.e 
drive is connected to a controller, it should be jumpered as the first logical 
unit (LUNO), and connected to the connectors prcvided for that ur.it. Whe- two 
or more drives are connected to a single controller, they are jumpered to 
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different logical unit numbers, and connected to the appropriate connectors on 
the controller. 

Here are some notes on the installation of several controller types: 

Xebec 1410, 1410A, and OWL - set the sector size jumper, labeled "SB" to the 
512 byte sector position, * labeled "5. M Set the controller address. This is a 
trace cut option on either the 1410 or the OWL. The Xebec controllers are 
shipped jumpered -for SCSI bus address 0, sg if you are only using one 
controller use that bus address. 

Adaptec ACB4000 - set the SCSI device ID jumper, J5, -for the desired 
controller ID. The ID is specified as a 3-bit binary code, with the least 
significant bit corresponding to A-B and the most significant bit E-F. The 
associated bit is a 0 when the jumper is off. If only one controller is on 
your SCSI bus, you can select bus address 0 by leaving off all of the address 
jumpers. The jumpers near Jl, labeled T, PU, R and S are used for write 
precompensation setup. Generally a single jumper should be inserted here, 
between R and S. 

Shugart 1610-4 - set its SCSI bus ID jumper (jumper pairs CU1, CU2, and CU4) 
for the desired controller address in the same manner as with the ACB4000. 
CU1, CU2, and CU4 on the Shugart controller correspond to jumper pairs A-B, 
C-D, and E-F on the Adaptec controller. No other jumpering is required. 



Adaptec and Shugart ID Jumpering 



SCSI 




Adaptec 




Shugart 




Bus ID 


D-E 


C-D 


A-B 


CU4 


CL'2 


CU1 


0 


out 


out 


out 


out 


out 


out 


1 


out 


out 


in 


out 


out 


in 


2 


out 


in 


out 


out 


in 


out 




out 


in 


in 


out 


in 


in. 


4 


in 


out 


out 


in 


out 


out 


5 


in 


out 


in 


in 


out 


in 


6 


in 


in 


out 


in 


in 


out 


7 


in 


in 


in 


in 


in 


in 



NOTE 

14 you are using multiple controllers, be sure only one of them has its 
SCSI bus termination resistors installed. 
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2-3 SOFTWARE INSTALLATION 



Make a copy of your normal system diskette, and label it as your "Hard Disk 
System 11 diskette. Copy the hard disk software utilities -from the ZSO Hard Disk 
Software diskette onto the new Hard Disk System diskette. Use the following 
procedure to generate your custom hard disk system configuration. 



Step Is Configure your CP/M system size. 

The more hard disk storage your system has, the more memory space CP/M requires 
for storage of directory-related information. As CP/M's space requirements 
increase, the space available to programs (called the Transient Program Area, 
or "TP A") decreases. The AMPRQ ZMOVCPM and MDVCPM utilities are used to 
generate various size systems; ZMOVCPM creates systems containing ZCPR3, while 
HOVCPM creates systems without 7CPR3. 

Here are the required sizes for various options of hard disk storage, based on 
the AMPRD BIDS Version 3 with the standard (built-in) ZCPR3 supports 



Hard Disk System Sizes 



Hard Disk Storage CP/M Size TPA bytes 

(none) 60K 56,070 

1-10 MB 59K 55,046 

11-42 MB 5BK 54,022 

43-74 MB 57K 52,998 

75-BB MB 56K 51,974 



NOTE 

A usable 60K system, without hard disk support, cannot be 
generated with ZMOVCPM or MDVCPM. Instead, the 60K floppy-only 
system is provided in boctable form on the system tracks of the 
standard AMPR0 ZB0 System Software diskette. 

Determine the required system size, and use the AMPR0 ZMOVCPM (or M0VCPM) 
utility to create a system image file configured for your requirements. (The 
required system size will be one or more K bytes smaller if ZCPR3 
configurations other than the "standard" built-in one are to be used.) 

NOTE 

ZM0VCPM.COM (or MDVCPM.COM) must be run directly from the CP/M 
(or ZCPR3) command line, not from a shell like MENU or FRIENDLY, 
since it prepares a memory image which might be corrupted by the 
shell program. Use the shell's exit command (X, <CTRL-C), etc.) 
to return to the AO) prompt before running ZMOVCPM (or MOVCPM) . 

For example, to create a 59K system, use the command: 



AO >ZM0VCPM 59 »< RETURN > 



The number "59" provides enough space for up to 10 megabytes of hard disk 
storage. ZMCVCPM will respond: 



CONSTRUCTING 59K CP/M vers 2.2 
READY FDR "SYSGEN" OR 
"SAVE 41 CPM59.COM" 

AO> 



Step 2i Write the new system to your Hard Disk Systea diskette. 

At this point, the new system image is stored in memory. Use the AMPRO SYSGEN 
utility to write the new system image onto the system tracks of a new 
(preformatted) diskette, by typing: 

AO > SYSGEN< RETURN > 

When SYSGEN requests the Source drive, respond with < RETURN > only, to tell 
SYSGEN to take the source from memory. When SYSGEN requests the Destination 
drive, enter the desired floppy drive letter. After you specify the 
Destination floppy drive letter, SYSGEN will prompt you for a < RETURN >. After 
SYSGEN writes the system to the Destination floppy diskette, the Destination 
drive prompt will again appear; this time, respond with a < RETURN > or <CTRL>-C 
to exit SYSGEN. 



Step 3s Set the powerup port configurations. 

Use* the AMPRO CONFIG utility to set the required port configurations and other 
initialization parameters on your new Hard Disk System diskette. This is 
required even though your current system disk's parameters may already have 
been set, because ZMOVCPM has created a system image containing the standard 
defaults (9600 baud terminal, etc.), which may diiier frcfr. your system's 
requirements. 



Step 4: Test the new system disk. 

Try booting from the new Hard disk System diskette. It should indicate the 
CP/M system size number (e.g. 59K CP/M), and BIOS Version 3, in the sign-on 
message. In case of difficulty, re-boot your system with a working system disk 
and use the CONFIG utility to recheck the terminal port setting, step rates, 
etc. 



Step 5: Format your hard disk. 

You can now procede to format your hard disk drive. Before you can use the 
AMPRO hard disk formatter (HFORMAT), you must complete the above steps, and you 
must have booted fro» the new Hard Disk System disk. HFORMAT will not run 
otherwise. Refer to the description of the AMPRO HFORMAT utility (Chapter 3). 

WARNING! HFORMAT will destroy all data on the hard disk drive. 

You need to have the following information handy when ycu run HFORMAT: 
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Controller j 



brand and model 



Drive: number of cylinders 

number of heads 
step rate 

cylinder at which to begin write precompensation, if needed 
cylinder at which to begin reduced write current, it needed 
cylinder to use -for landing zone, if needed 

In case of difficulty, re-boot from your Hard Disk System disk and verify from 
the system sign-on message that you have a 59K (or less) size CP/M system, and 
BIOS Version 3 or later. If these are correct, the trouble may be: 

o Faulty hard disk controller, drive, or cables 

o Incorrect controller or drive jumper settings 

o Incorrect controller or drive information given to HFORMAT 

o Incompatibility between hard disk controller and drive 

o Problem with your system's SCSI interface 



Step 6: Test hard disk initialization. 

Since the AMPRO BIOS supports a wide variety of SCSI (SASI) controllers and 
drives, as well as a wide range of CP/M drive partition sizes, the operating 
system must be initialized for your specific configuration. This will be done 
immediately after system boot, by the AMPRO HINIT utility. 

Refer to Chapter 3 for information on HINIT. At this point, you should run 
HINIT in its interactive "menu mode," responding to the program's prompts 
according to the characteristics of your hardware. Keep a list of all of your 
keystroke responses, as you will be making an automatic command file (alias) 
out of them shortly. You can create as many CP/M letter partitions on each 
drive as you like, using up the available K bytes of formatted capacity of the 
drive. 

After running HINIT (menu mode), try reading the directory of each of your new 
(empty) hard disk partitions using the DIR utility. If this doesn't work, or 
if the directory sizes do not seem correct, re-enter the initialization 
requirements with HINIT. If you still have problems, refer to the list of 
possible causes in the previous step. 



Step 7s Bad sector lockout. 

Since a hard disk drive has an extremely dense recording format, tiny defects 
can result in storage areas which are unusable. Typically, only several K 
bytes of disk storage space will be lost due to these defects. 

The Public Domain FINDBAD utility (Chapter 3) performs a read of every sector 
of each CP/M drive letter partition you specify, logging all errors encountered 
during the process. After the specified drive partition is fully checked, all 
of the bad sectors are grouped in a single file, called [UNUSED 3. BAD, in use'" 
area 15. Once the defects are grouped into this special file, no attempt to 
read or write to those areas of the drive will be made (unless you erase the 
file). 



Run FINDBAD once for each drive partition. For example: 

AO ) FINDBAD F: : FINDBAD Gt : FINDBAD H: ; FINDBAD I:<RETURN> 



Step Bt Create and test en automatic hard dimk initialization alias. 

In this step, you will use the ZCPR3 ALIAS utility to create an "alias" command 
file to automatically initialize your hard disk system. The required alias 
contains the precise set of HINIT keystrokes you used in Step 6, above, but 
with a comma used to represent the <RETURN> key and a period used to represent 
the <ESC> key. A good name for the alias you create is HARDINIT.COM. You can 
use a separate alias to initialize each drive or controller, or one alias can 
initialize them all. 

For example, the following HARDINIT alias command line might be used to 
initialize two 5 megabyte drive partitions (F and G) on a single 10 megabyte 
drive, connected as logical unit 0 (LUNG) on an Adaptec controller: 

HINIT YD010 AF5000,AG5000,. 

Refer to the program description of HINIT (Chapter 3) for further details. 

After you create the HARDINIT.COM alias required by your system, test it as 
follows: re-boot from your Hard Disk System diskette, to clear out the effects 
of Step 6; then type the command: 

AO > H ARD I NI T <"' RETURN > ' 

Then try again to access the (empty) directories of all of the drive letters 
your alias has just defined, using the DIR utility. (Problems? See Step 6.) 

Step 9i Write your system tracks to the first hard disk partition. 

Use the AMPRO SYSGEN utility to copy the system tracks from your Hard Disk 
System diskette to your first hard disk partition. 



Step 10: Configure your system disk for automatic initialization. 

In this step you will configure your Hard Disk System disk tc perform all 
required initialization, including complete transfer of operation to your hard 
disk partitions. To do this, you create another ALIAS which gets everything 
going just the way you want it. 

Here is an example. Let's assume you have created a system with two 10 
megabyte drives, partitioned as four 5 megabyte CP/M drive letters, F through 
I. The standard system disk contains an alias which is useful for this 
configuration, called HSTART.COM. It contains the following command line: 

HARDINIT; SWAP AF BG CH DI.j STARTUP 

This performs the following three steps: 
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(1) Initializes your hard disk system, according to the alias 
HARDINIT.COM you created in Step 8. 

(2) Reassigns drive letters, such that -floppy letters A-D are swapped 
with hard disk drive letters F-I. 

(3) Continues operation -from the first hard disk drive partition (now 
called "A"), based on the contents of a STARTUP. COM alias you put 
there. 

One final touch; set "HSTART" as the system autocommand, using the AMPRO 
CONFIG utility. Now, when you boot from your Hard Disk System diskette, your 
hard disk system will automatically be initialized, the hard disk drive letters 
(F-I) will be swapped with the floppy drive letters (A-D), and the command line 
contained in the STARTUP.COM alias on the first hard disk drive partition will 
run. Try it! 



i CONGRATULATIONS! 

■ 

: This completes your hard disk system installation. 
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CHAPTER 3 
PROGRAM DESCRIPTIONS 



3. 1 INTRODUCTION 

This chapter contains detailed information on each of the AMPRO ZBO hard disk 
software utility programs supplied on the AMPRO Hard Disk Software diskette. 
Each program's description explains what the program does and how it is used. 
The utilities are covered in alphabetical order, so this material can serve as 
a handy operator's reference. 

Each program description is identified with a version number. When the utility 
program is run, its version number (and a revision level) appear in the 
program's sign-on message, for example: 

AMPRO Copy/Format/Verify Utility 
Copyright (C) 1984 AMPRO Computers, Inc. 
Version '1.6 

In this case the program is Version 1, Revision 6. Revisions of a utility 
program having the same version number operate in the same manner. If a future 
version of a particular utility program requires a new description, its version 
number will be changed, to indicate that the old description is no longer 
accurate. Program descriptions for the new program version will be available, 
so that you can update this manual. 



3.2 PROGRAM DESCRIPTIONS 

The following pages contain the program descriptions of the AMPRO 2t§0 hard disk 
software utilities, alphabetically arranged. 
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FINDBAD 



(Version 6) 



Description 

Since a hard disk drive has a very densely packed storage surface, minute 
defects can result in small areas which are unusable. Some controllers can 
automatically "map" these bad spots (defects) out of use during operation, 
while others can not. The AMPRO hard disk. BIOS does not utilize this option, 
since each controller does this differently. Instead, the FINDBAD bad sector 
lockout program is used to allocate all of the bad areas of a disk's surface 
into a single file. As long as you never erase this file, the bad spots on the 
disk will never be used for program or data storage. Typically only several K 
bytes of disk storage will be lost due to these defects. 

The FINDBAD utility is a public domain program which provides bad sector 
lockout. FINDBAD performs a read of every sector of the CF'/M drive letter you 
specify, logging all errors encountered during the process. After the 
specified drive is fully checked, all of the bad sectors are assigned to a 
single file, called C UNUSED 3. BAD (in user area 15). Once the defects are 
grouped into this special file, no attempt to read or write to those areas of 
the drive will be made (unless you erase the [UNUSED 3. BAD file). 



Operation 

Before vol- can use FINDBAD, your hard disk must be formatted (see H r 0F: M A7) , and 
your system initialized (see HINIT). You must run FINDBAD ones for each drive 
letter you will be using, even if several drive letters recresent CF/M 
partitions on the same drive. 

To run FINDBAD, you simply type the program's name along with the CF7M drive 
partition letter, followed by a colon. For example, to run FINDBAD on drive 
letter F, enter the following command from the CF7M command line: 

AO FINDBAD F; < RETURN > 

The program will display status messages indicating its progress, and the 
locations (if any) at which bad disk sectors are found. 



NOTE 

The file created, t UNUSED 3. BAD, is placed in user area 15 by 
FINDBAD. It must be left as is. To protect it, you can use the 
following STAT.COM command* 

AO > STAT I UNUSED 3. BAD $R/0<RETURN> 



You can also run FINDBAD on a drive which is not empty, if vcu suspect that it 
contains bad sectors. In this case, files already on the d^;ve will net be 
harmed, and the resulting [UNUSED3.BAD file will collect all blocks containing 
bad sectors at that time. 
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HINIT 

(Version 1) 



Description 

This utility performs disk controller initialization and CP/M BIOS installation 
•for use of hard disk drives and SCSI hard disk controllers. When your system 
boots (on power-up or reset), a number of BIOS parameters must be set prior to 
access of the hard disk drives. Also, some hard disk controllers require 
initial izaticn before use. HINIT provides the facility for performing these 
operations. HINIT has two modes of use: Menu Mode, and Command Line Mode. 

HINIT provides controller initialization for only one type of hard disk 
controller, the Xebec 1410 (or 1410A). Most SCSI hard disk controllers 
currently being manufactured do not require initialization. These self- 
initializing controllers are referred to as "SCSI Generic." They automatically 
initialize themselves on powerup from parameters which they write to a reserved 
area on the hard disk drive when they format the drive. Controllers known to 
be SCSI Generic are: Adaptec, Shugart, Xebec OWL. 

IMPORTANT 

Since SCSI Generic controllers depend on initialization 
information which they write to the disk drives during format, 
your drives must be formatted first, before you attempt to use 
HINIT. 

The AMPRO Version 3 BIOS classifies SCSI Generic controllers in two ways: 
those which can support burst data transfer over SCSI, and those which require 
byte-by-byte handshaking. HINIT prompts you to select either "burst-mode" or 
"byte-mode" for SCSI Generic controllers. As implemented, burst mode 
controllers provide a 10-20 percent speed advantage over byte mods controllers. 
The Adaptec ACB4000 can be used in burst mode, while the Shugart 1610-4 
requires byte mode. These designations are specific to the AM c *R0 application, 
and are not standard terms, so you won't find this information in your SCSI 
controller's technical manual. It is recommended that you use any unlisted 
controller in byte mode, until you thoroughly exercise the system with the 
burst-mode specified. 



Menu Mode Operation 

To invoke HINIT* s interactive menu mode, simply type the program's name from 
the CP/M command line: 

AO > H I N I T < RETURN > 

HINIT will prompt you for all required information. The initial prompt asks: 

Do you want to clear the existing hard disk assignments (Y'N>? 

This provides the option of doing all desired initialization in one run of 
HINIT, or using HINIT several times to initialize multiple drives or 
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controllers. 



HINIT next displays its main menus 



Options available: 

(D) De-fine the Current Drive 

(A) Add a partition to the Current Drive 

(ESC) Exit the program 

What next (D/A/ESO? 



The steps you will perform are: 

Defining the "Current Drive" - use the "D" option, to de-fine a new "current 
drive." HINIT will prompt you for the controller's SCSI ID and type, and the 
drive's logical unit number (LUN), as jumpered on the drive. A single disk 
drive may contain more than one CP/M drive letter partition, as specified in 
the ne;;t step. 

Since the Xebec 1410 and 1410A controllers require power-up initialisation, 
when you specify one of those controllers you will be prompted tc supply the 
same drive-related information required by HFDRMAT, namely: number of 
cylinders, number of heads, RWC cylinder, WPC cylinder, and drive step rate. 
(See HFDPMAT for more information.) 



Defining CP/M partitions on the drive - after you define the current drive, 
HINIT will return you to the main menu options (D/A/ESC) . . Use the "A" option 
to define the CP/M drive sub-partitions tc be built on the current drive. 
HINIT will prompt you for a CP/M partition letter (starting from F> and a 
partition size. The drive partition size, entered in Kbytes, can be anything 
from 1 to 8192 (Kbytes). (A Kbyte is 1,024 bytes.) 

A drive partition can be thought of as a "logical" disk drive, and has its own 
drive letter (F, 6, H, etc., up to P) . A single disk drive may have as many 
CP/M partitions as you wish. However, there are only 11 available partitions, 
so use then: wisely! 

After each additional CP/M partition you specify, HINIT will return tc its main 
menu, asking you if you wish to define an additional C C 7M partition on the saue 
<"current") disk drive, define a new (additional) "current" disk drive, or exit 
to CP/M. When you are finished specifing all the required drives and 
partitions, use the ESC option to exit HINIT. 

NOTE 

Each time you specify a CP/M drive partition size, HINIT will 
indicate how much BIOS buffer space remains. If you run out of 
space, you will need to use the AMPRO ZMDVCPM utility tc ma's a 
smeller size CP/M system. If you plan to install an alternate 
ZCPR3 configuration requiring additional BIOS buffer space (IK, 
2K, etc.), be sure HINIT indicates sufficient buffer space 
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remains for your requirement after the highest letter CF7M drive 
partition is specified. 



The total formatted capacity of a given drive depends on the controller to 
which it is connected. Assuming the controller you are using reserves one 
cylinder for its own use, you can calculate the available s^ace on each ha^d 
disk drive from the number of cylinders (CYLS), the number of heads (HDS>, and 
the number of 512 byte sectors your controller writes on each cylinder 
(SECTORS) • as follows: 



The value you use for SECTORS depends on the particular controller, and, in 
the case of Adaptec controllers, on the interleave you specified when you used 
HFQRMAT to format the drive. Typical values are: 



After you run HINIT in its Menu mode, try the ZCPR3 DIR program (Chapter Z) on 
each CP/M partition you have created. The DIR program will show the space 
allocated to each CP/M partition. The number of Kbytes of space should be 32K 
smaller than what you specified in HINIT, due tc directory space requirements. 
After you have established that all CP/M partitions a^e as you wish, run the 
Public Domain FINDBAD program to remove any bad sectors from usable disk space. 
FINDBAD will also let you know if you have attempted to use more capacity than 
your drive actually has. 



Command Line Mode Operation 

HINIT would not be a very useful program if you had to manually enter all 
required information every time you booted your system. However, thanks to 
HINIT' s Command Line mode, you can create a ZCPR3 ALIAS tc initialize your 
system for you. 

To create an automatic initialization ALIAS, first run HINIT in its Menu mcde. 
and keep a careful record of all of your keystrokes. After checking to see 
that everything has been initialized to your satisfaction, create an ALIAS 
containing a command line containing: 



where the parameters are characters representing the precise sequence of 
keystrokes you used when you used HINIT in its Menu mode, with the following 
exceptions: substitute a comma for the <RETURN> key, and a period for the 
<ESC> key. Be sure to end with a period, corresponding to the <ESC> used to 
exit HINIT back to CP/M. 



FORMATTED CAPACITY « CCYLS-H X HDS X SECTORS X .5 



Adaptec ACB4000: 
Adaptec ACB4000: 



IB (with interleaves of 2 or more) 

17 (with interleave of 1> 

17 (all interleaves) 

17 (all interleaves) 



XEBEC 1410, 1410A: 
Shugart 1610-4: 



HINIT {parameters} 
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He^e is a sample HINIT command line: 

HINIT YD010 AF5000,A55000,. 

It does the following: 

Y clear any previous initialization 

D indicates a new "current drive" 

0 controller SCSI ID is 0 

1 controller type is SCSI burst-mode generic 
0 drive logical unit number (LUN) is 0 

(space has no effect; used for clarity) 
A additional CF7M partition on the same drive 

F selects CF7M partition letter F 

5000 size of CP/M partition F is 5,000K bytes 
, represents < RETURN > 

(space has no effect; used for clarity) 
A additional CP/M partition on the same drive 

G selects CP/M partition letter G 

5000 size of CP/M partition G is 5,000K bytes 
, represents < RETURN > 

represents <ESC> 

Spaces can be used in the command line for ease of understanding; they have no 
effezt. Both CP/M partitions defined in this example are on the same physical 
drive. If the two 5 MP partitions were on separate drives (e.g. LUN0 and LUN'l 
on the same controller), the command line would have been: 

HINIT YD010 AF5000,D011 AGEOOO, . 
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HP ARK 



(Version I) 



Description 

The HPARK utility moves the read/write head(s) of one or more hard disk drives 
to a predefined safety zone on the disk surface, to guard against accidental 
data loss due to either power on/off glitches in the drive electronics or 
media damage due to mechanical shock. You should always use HPARK to "park" 
your drives* heads prior to switching off AC power. After HPARK finishes 
positioning the disk heads it halts all system operation; the only recovery 
from system lockup after HPARK is by means of a system reset. 



Menu Mode Operation 

To use HPARK in its interactive "menu" mode, type the program's name from the 
CP/M command line: 

AO > HPARK; RETURN > 

For each drive you wish to park, you will be prompted the following 
information: 

(1) SCSI ID of the controller tc which the drive is connected (0-7) 

(2) Drive Logical Unit Number (0, 1, 2, or 3) 

(3) Controller type, if listed 

(A) Block number location for head positioning. This step is skipped if yc.r 
controller type is "listed" (Step 3). If your controller is unlisted, 
then you are prompted for a block number. Calculate the block number^ as 
f ol 1 ows: 



: block number = [cylinders X sectors/track X heads] - 1 : 



Where 

cylinders * the number of cylinders on the drive; or the special parking 
zone cylinder number, if the drive provides one 

sectors/track - the number of 512 byte sectors the controller formats per 
track. This depends on the controller. For example... 
Xebec: 17; Adaptec: IB for interleaves of 2 or greater but 17 
for an interleave of 1: Shugart: 17. 

heads = the number of heads on the drive 
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NOTE 

The Xebec 1410/1410A controllers do not allow HPARK to seek beyond the 
last cylinder number defined by the HINIT utility. One way to get around 
this is to define one mo r e cylinder in your HINIT alias than you are 
actually using in your CF/M drive partitions. Then use this extra 
cylinder as your parking cylinder. 



Command Line Mode Operation 

Once you have tested HPARK on your drives using the program's menu mode of 
operation, you will probably want to create a ZCPR3 alias to park your drives, 
in the same way you use an alias to perform the powerup initialization of your 
hard disk system (see HINIT). 

HPARK allows you to specify everything directly from the command line, or from 
within an alias. The general form of the command line mode usage is: 

AO) HPARK {parameters} 

As with HINIT, the "parameters" in the command line consist of the keystrokes 
you use in HPARK' s menu mode, except that you substitute a comma for the 
<RETURN> key. End the parameters with a period. 

Use the ZCPR3 ALIAS program to create a command file, containing the HPARK 
command line required to park your system's drives. Here are some examples: 

This HPARK command line is for a pair of Minisz^ibe 3012 drives connected as 
logical units 0 and 1 on a Xebec controller with SCSI ID 0: 

HPARK 00*20807, 01#20807,. 

Here is one for the same pair of drives connected to an Adaptec ACB4000: 

HPARK 00A,01A,. 

The ACB4000 is listed in HPARK' s controller type list, so the letter "A" takes 
the place of the block number. 
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LITTLE BOARD/ PLUS SCSI BOOT EPROM 



November 1, 1 985 



ft * I nt rod ucti on 



The AHPRO SCSI/PLUS bus interface represents a significant advance in 
sing I e~~ board —computer architecture, by providing a general purpose, high 
performance, inter processor data channel. The most obvious use of the 
SCSI/PLUS bus interface is for the addition of SCSI <SASX> ha.^d disk 
controllers and drives.. However, this is not the only use for the SCSI /PLUS 
bus* 



B. Boot Algorithm 



In order to provide a general purpose "hook" for a variety of SCSI /PLUS 
applications, the Little Board /PLUS SCSI BOOT EPROM allows the hoard to "boot" 
directly from SCSI, without the need for an attached floppy disk drive* Here 
is what the new SCSI BOOT EPROM does when the board is RESET s 

(1) Checks for the pr-&%><snc&! of a bootable floppy* If one is present, it 
attempts to boot from the floppy. If this fails. . « 

<2> Reads its SCSI ID <0~-8> from the ID Input Register, and either 8 

(3) If the board's ID is 7, performs an SCSI bus reset and then attempts 
to boot from SCSI device ID 0. If this fails, return to step < .1 ) * 

— or ~~ 

(3) If the board's ID is not 7, does not perform an SCSI bus reset « 
Attempts to boot from SCSI device ID 7* If this f ai Is, return to step < 1 > « 

This boot algorithm provide© a means to easily establish a master/slave 
hierarchy, where the device which is- jumpered to ID 7 is the system master* 
It must be responsible to provide the bootstrap software for all devices which 
are jumpered to addresses other than 7. This process is very straight 
forward? the bus master simply emulates an SCSI hard disk controller as far as 
the slave processor is crciria&'rn&d * 



C* Installation of Hard Disk Autoboot 



In keeping with the general "philosophy 11 of SCSI, the SCSI BOOT EPROH 
does not make any assumptions about the type of disk controller it is booting 
from, nor about any characteristics of the hard disk drive (i.e., tracks, 
heads, step rate, etc- ) « For this -reason, automatic booting from a hard disk 
can on 1 y be done when u© i ng SCS 1 cont ro 1 1 ers wh i ch initialize themse 1 ves 
*ypfc^ma t i ca 1 1 y on power-up. 



Of the controllers supported by the ftffPRO Hard Disk Software, the 
following may be used for automatic hard disk boot ing s 

Adaptec 0C.B-4000 and ftCB.-SOOO series 



ABDec uwl como 3l nau i on anve/ cr wrt r« .t. t=? r 



The Xebec 1410 and 14 I OA, and the DTC 5 1 OA and 51 OB are not self- 

initializing* These controllers require the addition of installation-specific 

commands in either the SCSI BOOT EPROH or the boot strap loader (contained in 

the HGEN utility), in order to initialize the controller prior to drive 

q^^tss. Hooks have been provided in the SCSI BOOT EPROH code for this 
ibse. 



Here is how to pr-Bp^re a Little Board— based system for automatic booting 
from a hard disk- Replace your old BOOT EPROM with the new SCSI BOOT EPROM, 
and then perform the following steps: 

<i> Hardware Setups Install your system's hardware as described in Chapter £ 
of the AMPRO ZBO Hard Disk Software User's Manual . In addition, for hard disk 
auto boot g SCSI ID 1 s should be set as follows: 

o I n i t i at or I D Jumper i ng s The L i t tie Board / PLUS i s t he SC9 1 

."Initiator." Jumper it to SCSI ID 7, axs shown in Little Board /PLUS 
technical manual- 

o Target ID Jumpering: The SCSI disk controller is the SCSI "Target- " 
Jumper the controller to be booted from as SCSI ID 0, according to the 
controller's installation manual . Also, the drive to be booted from 
must be connected as Logical Unit Number < LUN > 0. 

<&> Initial Software Setups Install and test the standard AMPRO ZBO Hard Disk 
software and hardware* as described in Chapter & of the Hard Disk Software 
User's HanuaL This incl udes s 

o Running HF0RMAT 9 to format the drive. 

o Running HINIT, to initialize your system's BIOS. 

o Running SYS8EN, to write the operating system to the first hard disk 
partition. This is "F" pr i or to running SWAP. 

o , Running SWAP, to re—assign drive letters the way that you want them. 
Be sure you have assigned drive letters so that the first h^d disk 
. partition is now drive "A." 

<3> Final Software Installations This is the easy part. All you have to do 
now is run the AMPRO HGEN utility, and respond to the program's prompt with a 
"y« n That' s al 1 there is to it? Remove your floppy diskettes from your 
system, and press RESET. After a brief delay <5 to 10 seconds) to allow for 
floppy timeout, your system should boot direct ly from your h&r-d disk. 




HGEN 



(Version 1 ) 



Descript ion 



This utility modifies the system tracks on your hard drive to perform disk 
controller initialization and CP/M BIOS installation to support automatic 
booting from the hard disk drive* When your system boots (on power -up or 
reset > , a number of BIOS parameters must be set pr-iar- to access of the hard 
disk drives* Also, some hard disk controllers require initialization before 
use. HQEN provides the facility for installing these rout i nes on the system 
tracks* 



HBEN provides controller initialization on reset for two types of hard disk 
controllers, the Xebec 14 10 <P> , and the DTC 5iO <A/8> - Most SCSI hard disk 
controllers currently being manufactured do not require initialization. These 
se 1 f i n i t i a 1 i z i ng cont ro I I ers are referred t o as " SCS I Gener i c. " They 
automatically initialize themselves on power up from parameters which they write 
to a reserved area on the hard disk when they format the drive- Controllers 
known to be SCSI Gener i c ares ftdapt ec 9 Shugart, and Xebec OWL. 

prov i des a *& i m i 1 ar initializ at 1 on mechan i sm for non SCS I Gener i e 
oilers. Host controllers initial i ze themselves to a specific default 
drive type* For instance, the DTC 500 series default to an ST-50S type drive, 
with 4 heads and 153 tracks. This default initialization is sufficient to 
allow reading in the boot sector and system tracks from the hBrd disk. Since 
the system tracks occupy 33 sectors, they will be completely contained on the 
first platter of cyl inder 0. This means that it is not necessary to move the 
heads off cylinder 0 in order to read the system tracks on any hard drive that 
is formatted with at least IS SIS byte sectors per track. Once the system 
tracks have been read, the controller is initialized with the correct number of 
heads and cylinders for your hard disk,, 

Before running MGEM, you must have first meet the following requi rement s s 

« ImS 
» pmS 

o your SCSI boot HP ROM must be version ,t„3 or higher 
o the Little Board SCSI address must be set to 7 




o the hard drive SCSI controller Bddr-&'BB must be set to 0 

o the hard drive addressed as LUN 0 on this controller must have been 

format ted 

o the systems tracks on the hard drive must have been SYSGENetf from your 
Hard Drive System faster floppy disk 

o HINIT must have been run to initialize the controller, and at least one 
CP/yi .partition must have been defined 

o SWAP must have been run to make the first bard drive partition drive A« 



« pm 

HGEN will only initialize the hard drive addressed as LUN 0 on the hard drive 
controller at SCSI address 0. All other* controllers and hard drives should be 
i n i t i a 1 i z e d u s ;l n g WIN 1 1* afte r b o o t u p „ 

; TS^^nvoUe MGEN* s interactive? menu mode, simply type the program's name from the 
CP / M command 1 i ne k 

AO HGEN < RETURN) 

HGEN will prompt you for all required information* The initial prompt askss 

fire you sure you want to continue <Y/N) ? 

Answer Y to this prompt if you want to install the automatic boot up changes on 
t h e h a r d d r i v e » 

Next , you will be prompted for the hard drive controller type- HGEN supports 
the following SCSI control lersn 

• ImB 

o Generic SCSI burst mode controllers 

o Generic SCSI byte mode controllers 

o Xebec 1410(A) 

o DTC 500 series-;- 



v pm 

If your controller is a generic SCSI type, HGEN will go ahead and make the 
changes to the system track and inform you that you can now boot directly from 
the hard drive. For the Xebec and DTC controllers, you will be prompted for 
the drive characteristics of the drive addressed as LUN 0. This information is 
the same drive—related information required by HFORMAT and HINIT, namely s 
number of cylinders, number of heads, RWC cylinder, WPC cylinder, and drive 
step rate- 

HBEN will complete the changes to the system track momentarily- Once it 
finishes, park the heads of the drive, press RESET, and after the floppy drive 
t i mes out , your sy st em will boot d i rect 1 y from the hard disk* 



This lihv-^ry contains new versions of HO EM and SCSI BOOT* HBEN has been extended 
tjfmi^vBt a I 2 BOB I cent no 1 1 en i n 1 t i a 1 i z at i on i n the hand dr i ve boot sect or. Th i s 
A 1*& automatic booting from non generic SCSI controllers, such as the Xebec 
3%m*v < A ) a n d t h e DT C 5 1 0 < A / B > 9 a s w e 1 1 a s g e n e r i c SCS I c o n t r o 2 1 e r s „ 

HBEN V 1 « 3 will not function with the VI. ■ S SCSI boot EPROM. A bug in the SCSI 
routines in the boot EPROM that prevented the SETPRAM routine from functioning 
has been corrected in the VI * 3 EPROM,, 

Much of the new material in HBEN was lifted from HINIT. The corrections to the 
SCSI routines in the boot EPROM were taken from the V3« B BIOS source* All 
source listings are copyri ghted material of Am pro, Inc. , and could not be 
i no 1 uded i n t he 1 i brary for genera 1 d i st r i but i on* Th ey are ava i 1 ab 1 e on Ampro' s 
BBS at < 408 > 734-8980 in the LBZBO -SOURCE section for licencees of Ampro 9 s 
source code. 

These programs have been tested in a Little Board/Plus, using a DTC—SIOB 
controller, connected to an I MI 5018 drive* SCSI Generic controllers should 
experience no problems with these new files, as they do not require specific 
i n i t i a 2 1 z at i on * Th e X e bee 1 4 1 0 < A ) sh o u 1 d wor k (based on t h e comment s by 
John Lin in 1 4 ! 080QT- TXT) , but has not been tested* 

Files in this library 

— READ- M E — this file 

HG— 1-3. COM - HBEN 1 « 3 executable f i le 

HS In 3m DOC - HBEN i * 3 document at ion f i le 

SJT-1-3* HEX - SCS I BOOT 1.3 Intel HEX format file 

f|-3, ROM - SCSI BOOT i , 3 binary image file 

November 3 ? 1986 

Wayne Hort ens ius 
.1. 08~ 1 4C8 P icker i ng Parkway 
P i eke r i n g On t a r i o 
CANADA L1V 3V7 
<4.t&> 480-3785 



AMPRO BIOS UPDATE PROCEDURE 
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A « I y i t r o d u c t i o n 



When you update your system from either a BIOS binary or "hex" file, you first 
use the AM PRO ZWOVCPM (or MOVCPM) utility to first a system image file of the 
desired system "size. " Then you use the CP/M DDT utility to merge the 
appropriate BIOS update file with your system image file- 

AMPRO B I OS upclat e f i 1 es are current 1 y d i st r i but ed as b i nary f i 1 es. B 1 OS 
update files can also be distributed in "HEX" format, The two (binary and 
HEX > methods are equivalent $ we have switched to using the binary file scheme, 
since the v-equiv-ed files are smaller* and the update procedure is easier- The 
two procedures below cover both cases. 

Before you start, decide what "size" system you will require- The Btm^da^rd 
distri but ion system, based on the Version 3 AMPRO BIOS, is a "BOH" system* 
This is a floppy— only configuration, with a mini mum set of ZCPR3 functions. 
You can tell what system size you are currently using by observing the system 
signon message when you first "boot" your system. 

If you are plan to install hard disk support, or extended ZCPR3 features, you 
wLJU require a smaller system size than BOK, to make more operating system 
m /p a v a i 1 a b 1 e f o r t h e s e a d d i t i o n a 1 feat ures. C o n s u 1 1 t h e h ard d i s k o r 
^/nded ZCPR3 software documentation to determine what system size will be 

requ i red™ 

The BIOS update files have names of the forms wiBJOSmm* HEX, or nriB I OSrnm -BIN. 
The first of these represents a BIOS "HEX" file of AM PRO BIOS Version "rm" and 
system si ze "mm" Kbytes, while the second is a BIOS binary file of the same 
version and system size*. For example, "34B10S58.BIN" contains BIOS Version 
3*4 and can be used to update a "58K" system,, 

Assuming you know what system size you require (BOK, 59K, etc.), use one of 
the following two procedures to update your operating system with a new BIOS 
version,. In both procedures, the example given assumes BIOS Version 3-4 and 

system size of SDK* 



B. Updating your Operating System from a BIOS Binary File 



:l« Place a copy of 34B10SB0.BIN" on your system disk. 

2. Create a system image < "OLDSYS- BIN" ) of your old system as follows^ 

AO) ZMOVCPM SO * < RETURN) 

CONSTRUCTING 5SK GP/M vers 2. S 
READY FOR "SYSGEN" OR 
"SAVE 41 CPM60.COM" 

AO>SAVE 49 OLDSYS- BIN < RETURN) 

(It's always OK to save 49 pages-) 



AO) DDT DLDSYS.BIN 
DDT VERS a. a 
NEXT PC 

a ago 0100 

-I34BIQS60. BIN 

■-R1E80 
NEXT PC 
SAOO EEOO 
GO 

AO SAVE 49 NEWSYS. BIN 

< NOTEs the read offset of 1E80 is the same for ail system ) 
{ sizes, when a BIOS binary file 1b used. ) 

4. Finally, install the new system on a (formatted) diskette as follows: 

AO BY SG EN NEWSY8.BIN 

Dest i nat i on Dr i ve? (A, B, C, or D ) 

Then spec i f y a des i red dest i nat i on d isket te« 



C« Updating your Operating System from a BIOS HEX Fi le 



L Place a copy of 34B I 0360. HEX " on your system disk. 

S. Create a system image < "OLDSYS- BIN" ) of your old system as follows: 

AO ZMOVCPM 60 *•< RETURN) 

CONSTRUCTING 5BK CP/H vers 2. a 
READY FOR "SYS8EN" OR 
"SAVE 41 CPMSO* COM" 

AO SAVE 49 OLDSYS. BIN < RETURN) 

(If s always OK to save 49 pages. ) 

3„ Mow create a new system image file (NEWSYS.BIN) as followsa 

AO) DDT OLDSYS.BXN 

ddt vers a.e 

NEXT PC 

a aoo o i oo 

--I34BI0S60. HEX 
***" R 3 w«? 8 O 
NEXT PC 
E'AOO EEOO 

•-GO 

AO) SAVE 49 NEWSYS.BIN 

C NOTE : the read offset of 3580 is based on a "60K system" 

i which is standard for BIOS versions 3* x — for other size 

C system®, different offsets are required, as follows: 

< 

( MSI ZE equate. value <K> 

\ "•** **"* ■ 

< 



61 
60 



59 



offset amount <H) 

3180 
35S0 
3980 



i 58 4580 > 

4* Finally, install the new system on a (formatted) diskette as f ol lows: 
AO) BYSOEN NEWSYB. BIN 

Destination Drive? (ft, B, C, or D) 



Then ^p^aify a 



des i red dest i nat i on d i sket t e» 



